home *** CD-ROM | disk | FTP | other *** search
/ The Essential Home & Business Collection / The Essential Home & Business Collection.iso / 23 / 1 / 6 / EXE2COM.DOC < prev    next >
Text File  |  1987-04-17  |  5KB  |  137 lines
  1.                                   EXE2COM 1.00
  2.                          By Chris Dunford/Cove Software
  3.  
  4.         Purpose
  5.         -------
  6.         EXE2COM is a one-for-one replacement for the EXE2BIN program
  7.         that was formerly distributed with DOS.  Beginning with DOS 3.3,
  8.         EXE2BIN has been moved to the disk that comes with the DOS
  9.         Technical Reference and thus is not available without extra
  10.         cost.
  11.  
  12.         Usage
  13.         -----
  14.         Usage is identical to DOS's EXE2BIN except that the output file
  15.         extension defaults to COM rather than BIN (when was the last
  16.         time you saw a BIN file?).
  17.  
  18.         Complete usage is:
  19.  
  20.             EXE2COM [d:][path]file[ext] [d:][path][file][ext]
  21.  
  22.         The drive and path of the first file default to the current
  23.         drive and path, if not specified.  The extension of the first
  24.         file defaults to EXE, if not specified.
  25.  
  26.         If the second file is completely unspecified, it defaults to the
  27.         same drive, path, and filename as the first, except that the
  28.         extension will be COM.
  29.  
  30.         If the second file is specified but without an extension, COM
  31.         will be assumed (this is different from EXE2BIN).
  32.  
  33.         The simplest (and usual) usage is simply:
  34.  
  35.             EXE2COM file
  36.  
  37.         which will take the named EXE file in the current directory and
  38.         convert it to a COM file in the same directory.
  39.  
  40.  
  41.         Operation
  42.         ---------
  43.         EXE2COM runs the same way as EXE2BIN, with the following
  44.         exceptions:
  45.  
  46.             1. The binary fixup option of EXE2BIN (IP=0, segment fixups
  47.             required) is not supported.
  48.  
  49.             2. The EXE file checksum is not verified.
  50.  
  51.             3. Error messages are more useful, and a warning is provided
  52.             if a COM file is created with an initial IP other than 100H.
  53.  
  54.         Error Messages
  55.         --------------
  56.         These are EXE2COM's error messages.  If one of these is seen,
  57.         the EXE file will not be converted and the errorlevel returned
  58.         by EXE2COM will be 1.
  59.  
  60.         ERROR READING EXE HEADER
  61.             EXE2COM was unable to read the EXE file header from disk.
  62.  
  63.         ERROR WRITING OUTPUT FILE
  64.             EXE2COM was unable to write the converted file to disk.
  65.  
  66.         INVALID EXE FILE SIGNATURE
  67.             The first two bytes of an EXE file should be ASCII 'M' and
  68.             'Z'.  This was not the case, and it's probably not an EXE
  69.             file.
  70.  
  71.         EXE HAS RELOCATABLE ITEMS
  72.             In order to be converted to a COM file, an EXE file cannot
  73.             have any direct references to segments.  For example, the
  74.             assembler instruction "mov ax,code" (where CODE is a segment
  75.             name) is a segment reference.  One or more segment
  76.             references were found in the EXE file.
  77.  
  78.         EXE HAS STACK SEGMENT
  79.             In order to be converted to a COM file, an EXE file cannot
  80.             have a stack segment.
  81.  
  82.         EXE HAS NONZERO CS
  83.             In order to be converted to a COM file, an EXE file must
  84.             have a code segment that begins at offset 0 of the code
  85.             image in the EXE file.
  86.  
  87.         IP NOT 0 OR 100H
  88.             In order to be converted to a binary file, an EXE file must
  89.             have an entry point of 0 or 100H within the code segment.
  90.             For COM files, the entry point should be 100H.  For SYS
  91.             files (device drivers), the entry point should be 0.
  92.  
  93.         PROGRAM EXCEEDS 64K
  94.             In order to be converted to a binary file, the total size of
  95.             the code to be loaded (including the PSP) must not exceed
  96.             64K bytes.
  97.  
  98.         UNKNOWN ERROR
  99.             Internal error.  Notify the author.
  100.  
  101.  
  102.         Warning message
  103.         ---------------
  104.         EXE2COM has one warning message:
  105.  
  106.             COM FILE, INITIAL IP NOT 100H
  107.  
  108.         The entry point of all COM files should be 100H.  If you are
  109.         creating a COM file an the entry point is not 100H, EXE2COM will
  110.         do the job but let you know that there is a potential problem.
  111.  
  112.  
  113.         Source
  114.         ------
  115.         Source code should be included with this archive.  Users are
  116.         encouraged to modify, improve, and/or correct the source for
  117.         EXE2COM and submit the new program to the author for
  118.         distribution.
  119.  
  120.         The original EXE2COM executable file (date 4/17/87) was produced
  121.         using the provided source, except that the printf's were
  122.         replaced by a function from the author's library that produces
  123.         smaller EXE files.
  124.  
  125.         Public domain
  126.         -------------
  127.         EXE2COM is hereby donated by the author to the public domain.
  128.         The program should not be sold at any cost by any for-profit
  129.         organization.
  130.  
  131.         Author: Christopher J. Dunford
  132.                 The Cove Software Group
  133.                 PO Box 1072
  134.                 Columbia, MD 21044
  135.                 (301) 992-9371
  136.                 CompuServe 76703,2002
  137.